home *** CD-ROM | disk | FTP | other *** search
/ Ultimedia 1 / Ultimedia 1.iso / tools / soundtools / speechtoy / readme < prev    next >
Encoding:
Text File  |  1994-04-14  |  3.0 KB  |  97 lines
  1.  
  2. SpeechToy?  9 years later?????   Yep.
  3.  
  4. I thought it would be a kick for it to re-emerge as JForth source
  5. and executable.   (Ok, maybe I need to get out more.)
  6.  
  7. I've included the original C source code, in case you might
  8. like to compare them.  JForth is really very easy to port to
  9. from C.  I've also included some MARKS files (work with Textra 1.15
  10. & later) for both source files.  (the ones beginning with '}')
  11.  
  12. And thanks, Dave M Lucas.  I suppose that if you weren't before,
  13. you are now, an official pioneer!
  14.  
  15. Anyway, hope everyone gets some enjoyment out of this, at least
  16. as much as I did converting it to JForth.!
  17.  
  18. Incidentally, the CLONEd JForth program is 5K smaller than
  19. the Lattice C program, but in all fairness, the Lattice
  20. compiler is ancient (3.03).  I'm sure almost any other C compiler
  21. would generate smaller programs for reasons I won't go into.
  22.  
  23. For JForth guys lookin' for something to play with, this
  24. should be fun.
  25.  
  26. NOTE: I did fix a few things in the accompanying C source.  See
  27. my change history notes if you're interested.  In the JForth
  28. version, I added the 2.0 colors, shaded gadgets and the LOOP
  29. Button.  Other than that, it's a true & faithful port.
  30.  
  31. Enjoy.
  32.  
  33. Mike Haas
  34. 3867 La Colina Rd.
  35. El Sobrante, CA 94803
  36.  
  37. mikeh@starnine.com
  38.  
  39.  
  40. -------------  For JForth Users  --------------
  41.  
  42. To compile under JForth 3.0 or later...
  43.  
  44. 1. boot your working jforth program
  45.  
  46.    a. if CLONE is compiled, you will need only about 25K of
  47.       free dictionary space.
  48.       
  49.    b. if CLONE is not compiled, you will need about 70K of
  50.       free dictionary space.
  51.       
  52.    If necessary, increase your JForth size.  Refer to your manual
  53.    for details.
  54.    
  55. 2. 'cd' to the SpeechToy directory.
  56.  
  57. 3. INCLUDE Makefile.f
  58.  
  59. The above file will make sure CLONE is compiled, compile Speechtoy.f,
  60. clone the program, then save the executable in the SpeechToy
  61. directory.
  62.  
  63. If you want to just compile the program and run it from JForth,
  64. INCLUDE Speechtoy.f and enter MAIN.
  65.  
  66.  
  67.  
  68. ---- Found a Bug in 2.0+ Commodore include files!
  69.  
  70. I was very surprised to find that under 1.1, 1.2 and 1.3, the
  71. mouth values from the narrator device were always 0...
  72. (at least on my trusy old A1000).
  73.  
  74. Thus, when the face was presented under those OS versions,
  75. the mouth stayed a dot! :-(  The mouth worked fine under 2.1
  76. on my 3000 and under 2.04 on my 1000!??!
  77.  
  78. I finally tracked this down to a MAJOR incompatibility between the 
  79. 1.3-and-earlier and the 2.0-and-later include file 
  80. devices/narrator.h.  Basically, because Commodore changed the size 
  81. of the "narrator_rb" structure, the "mouth_rb" structure is not 
  82. binary-compatible between the old and the new OS versions.  This 
  83. means that programs compiled with 1.3 includes can only get mouth 
  84. values under 1.3, and the same for 2.0+.  They OS's are 
  85. incompatible in this respect.
  86.  
  87. I got it to work by doing different things under different
  88. versions of the OS, but that's me.  Other programs will
  89. compile fine under both sets of includes, but will only
  90. run under that OS version.
  91.  
  92. This will apply to all languages that use the Commodore
  93. include files in one way or another.
  94.  
  95.  
  96.  
  97.